Skip to content

Guide Density onboarding with background history sync#11

Merged
afar1 merged 1 commit into
mainfrom
codex/onboarding-recent-background-sync
Jun 25, 2026
Merged

Guide Density onboarding with background history sync#11
afar1 merged 1 commit into
mainfrom
codex/onboarding-recent-background-sync

Conversation

@jshanley

Copy link
Copy Markdown
Member

Summary

Updates the Density plugin onboarding flow around first-time setup.

  • Make the recommended path fetch 30 days for all locations first.
  • Start a background deeper-history job by default after the recent preload.
  • Add onboarding_status so agents can track that job and tell the user when full supported local history is ready.
  • Add a recent-only option for users who want to skip the background job.
  • Keep the specific-location option visible but unavailable until the CLI runtime includes scoped onboarding support.

Why

First-time setup should get users to useful local answers quickly without hiding that deeper local history is still loading. The agent needs a durable status surface so follow-up turns can report background progress instead of guessing from Parquet timestamps.

Notes

Specific-location onboarding should be enabled after DensityCo/density-cli#40 lands, is released, and the plugin pins a runtime containing density onboard scope / sync --scope.

The background job uses the existing CLI historical export path, so Data Access API observation requests keep the existing UTC calendar-month chunking behavior.

Validation

  • npm test

@afar1 afar1 merged commit 5f0bcaa into main Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants